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PROPERTY EDITOR GRAPHICAL USER INTERFACE APPARATUS, METHOD 
AND COMPUTER PROGRAM PRODUCT 

BACKGROUND OF THE INVENTION 

5 

1. Technical Field: 

The present invention is directed to an improved 
computing device. More specifically, the present invention 
is directed to a property editor graphical user interface 
10 apparatus, method and computer program product. 

2. Description of Related Art: 

In Java, for example, when a programmer is building a 

15 property, i.e. a data type, the programmer must also provide 
an editor for editing that property. The editor may be an 
editor that makes use of established editing methods 
supplied by Java or may be, for example, a custom editor 
having custom methods designated by the programmer. Thus, 

20 if a programmer creates three new properties, the programmer 
must also create three new property editors. For example, 
if the programmer creates a percentage property, a floating 
point number property, and a string property, the programmer 
must generate a property editor having a different graphical 

25 user interface for each of these different types of 

properties. As can be seen, as the number of properties 
generated increases, the time necessary to create these 
editors becomes burdensome. 

In addition, because there is no standard for providing 

30 these property editors, each programmer is free to create 
his or her own property editor without regard to how another 
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programmer might create the same property editor. That is, 
one programmer may create a first property editor for a 
property, the first property editor having a first type of 
graphical user interface, while a second programmer may 
create a second property editor for the same or a similar 
property having a different type of graphical user 
interface. Because of this, programmers must become 
accustom to a wide variety of property editors rather than 
there being a uniform look and feel to the property editors. 
Thus, the present state of the art does not encourage reuse 
of property editors and does not provide any standard by 
which programmers are assured that their property editors 
may be used by other programmers. 

Therefore, it would be beneficial to have an apparatus 
and method that encourages code reuse with regard to 
property editors and forces consistency between graphical 
user interfaces in property editors. 
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SUMMARY OF THE INVENTION 

The present invention provides an apparatus, method and 
computer program product for selecting and displaying 
5 graphical user interfaces for editing properties. With the 
present invention, a property editor of a property is 
analyzed to determine the methods associated with the 
property editor. Based on the methods associated with the 
property editor, one of a number of predetermined graphical 
10 user interfaces is selected. The selected graphical user 
interface is provided to a user, such as a programmer, who 
p may use the graphical user interface to thereby edit the 

Jrf property. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

5 The novel features believed characteristic of the 

invention are set forth in the appended claims. The 
invention itself, however, as well as a preferred mode of 
use, further objectives and advantages thereof, will best be 
understood by reference to the following detailed 
10 description of an illustrative embodiment when read in 
conjunction with the accompanying drawings, wherein: 

Figure 1 is an exemplary diagram illustrating a network 
data processing system in accordance with the present 
invention; 

15 Figure 2A is an exemplary diagram illustrating a server 

data processing device in accordance with the present 
invention; 

Figure 2B is an exemplary diagram illustrating a client 
data processing device in accordance with the present 
20 invention; 

Figure 3 is an exemplary diagram illustrating a Java 
Virtual Machine in accordance with the present invention; 

Figure 4A is an exemplary diagram illustrating a 
graphical user interface according to one embodiment of the 
25 present invention; 

Figures 4B and 4C illustrate example implementations of 
the graphical user interface of Figure 4A; 

Figure 5A is an exemplary diagram illustrating a 
graphical user interface according to another embodiment of 
30 the present invention; 
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Figures 5B and 5C illustrate example implementations of 
the graphical user interface of Figure 5A; 

Figure 6A is an exemplary diagram illustrating a 
graphical user interface according to yet another embodiment 
of the present invention; 

Figure 6B illustrates an example implementation of the 
graphical user interface of Figure 6A; and 

Figure 7 is a flowchart outlining an exemplary 
operation of the present invention. 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

The present invention provides a mechanism by which a 
graphical user interface is selected for use with a Java 
5 property editor based on the type of Java property editor 
that is to be used in editing a specified Java property. 
That is, the present invention determines what methods are 
associated with the Java property editor of a selected Java 
property to determine how to visually present a graphical 

10 user interface to allow editing of the property. The 
present invention may be implemented in a stand-alone 
computing device, a client device, a server device, or may 
be distributed between a client device and a server device. 
Moreover, the present invention may be implemented in 

15 conjunction with a Java Virtual Machine (JVM) , a Java editor 
application or applet, or the like. As such, the following 
Figures 1-3 are intended to provide background as to the 
environment in which the present invention may be 
implemented. 

20 With reference now to the figures, and in particular 

with reference to Figure 1, a pictorial representation of a 
distributed data processing system in which the present 
invention may be implemented is depicted. Distributed data 
processing system 100 is a network of computers in which the 

25 present invention may be implemented. Distributed data 
processing system 100 contains a network 102, which is the 
medium used to provide communications links between various 
devices and computers connected together within distributed 
data processing system 100. Network 102 may include 
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permanent connections, such as wire or fiber optic cables, 
or temporary connections made through telephone connections. 

In the depicted example, a server 104 is connected to 
network 102 along with storage unit 106. In addition, 
5 clients 108, 110, and 112 also are connected to a network 
102. These clients 108, 110, and 112 may be, for example, 
personal computers or network computers. For purposes of 
this application, a network computer is any computer, 
coupled to a network, which receives a program or other 

10 application from another computer coupled to the network. In 
the depicted example, server 104 provides data, such as boot 
files, operating system images, and applications to clients 
108-112. Clients 108, 110, and 112 are clients to server 
104. Distributed data processing system 100 may include 

15 additional servers, clients, and other devices not shown. 

In the depicted example, distributed data processing 
system 100 is the Internet with network 102 representing a 
worldwide collection of networks and gateways that use the 
TCP/IP suite of protocols to communicate with one another. 

20 At the heart of the Internet is a backbone of high-speed 
data communication lines between major nodes or host 
computers, consisting of thousands of commercial, 
government, educational, and other computer systems, that 
route data and messages. Of course, distributed data 

25 processing system 100 also may be implemented as a number of 
different types of networks, such as, for example, an 
Intranet or a local area network. 

Figure 1 is intended as an example, and not as an 
architectural limitation for the processes of the present 
30 invention. The present invention may be implemented in the 
depicted distributed data processing system or modifications 
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thereof as will be readily apparent to those of ordinary 
skill in the art. 

With reference now to Figure 2A, a block diagram of a 
data processing system which may be implemented as a server, 
5 such as server 104 in Figure 1, is depicted in accordance to 
the present invention. Data processing system 200 may be a 
symmetric multiprocessor (SMP) system including a plurality 
of processors 202 and 204 connected to system bus 206. 
Alternatively, a single processor system may be employed. 

10 Also connected to system bus 206 is memory controller /cache 
208, which provides an interface to local memory 209. I/O 
Bus Bridge 210 is connected to system bus 206 and provides 
an interface to I/O bus 212. Memory controller/cache 208 
and I/O Bus Bridge 210 may be integrated as depicted. 

15 Peripheral component interconnect (PCI) bus bridge 214 

connected to I/O bus 212 provides an interface to PCI local 
bus 216. A modem 218 may be connected to PCI local bus 216. 
Typical PCI bus implementations will support four PCI 
expansion slots or add- in connectors. Communications links 

20 to network computers 108-112 in Figure 1 may be provided 
through modem 218 and network adapter 220 connected to PCI 
local bus 216 through add-in boards. 

Additional PCI bus bridges 222 and 224 provide 
interfaces for additional PCI buses 226 and 228, from which 

25 additional modems or network adapters may be supported. In 
this manner, server 200 allows connections to multiple 
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network computers. A memory mapped graphics adapter 230 and 
hard disk 232 may also be connected to I/O bus 212 as 
depicted, either directly or indirectly. 

Those of ordinary skill in the art will appreciate that 
5 the hardware depicted in Figure 2A may vary. For example, 
other peripheral devices, such as optical disk drive and the 
like also may be used in addition or in place of the 
hardware depicted. The depicted example is not meant to 
imply architectural limitations with respect to the present 
10 invention. 

The data processing system depicted in Figure 2A may 
be, for example, an IBM RISC/System 6000 system, a product 
of International Business Machines Corporation in Armonk, 
New York, running the Advanced Interactive Executive (AIX) 

15 operating system. 

With reference now to Figure 2B, a block diagram of a 
data processing system in which the present invention may be 
implemented is illustrated. Data processing system 250 is 
an example of a client computer. Data processing system 250 

20 employs a peripheral component interconnect (PCI) local bus 
architecture. Although the depicted example employs a PCI 
bus, other bus architectures such as Micro Channel and ISA 
may be used. Processor 252 and main memory 254 are 
connected to PCI local bus 256 through PCI Bridge 258. PCI 

25 Bridge 258 also may include an integrated memory controller 
and cache memory for processor 252. Additional connections 
to PCI local bus 256 may be made through direct component 
interconnection or through add- in boards. In the depicted 
example, local area network (LAN) adapter 260, SCSI host bus 

30 adapter 262, and expansion bus interface 264 are connected 
to PCI local bus 256 by direct component connection. In 
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contrast, audio adapter 266, graphics adapter 268, and 
audio/video adapter (A/V) 269 are connected to PCI local bus 
266 by add- in boards inserted into expansion slots. 
Expansion bus interface 264 provides a connection for a 
5 keyboard and mouse adapter 270, modem 272, and additional 
memory 274. SCSI host bus adapter 262 provides a connection 
for hard disk drive 276, tape drive 278, and CD-ROM 280 in 
the depicted example. Typical PCI local bus implementations 
will support three or four PCI expansion slots or add-in 
10 connectors. 

An operating system runs on processor 252 and is used 
to coordinate and provide control of various components 
within data processing system 250 in Figure 2B. The 
operating system may be a commercially available operating 

15 system such as OS/2, which is available from International 
Business Machines Corporation. 

An object oriented programming system such as Java may 
run in conjunction with the operating system and may provide 
calls to the operating system from Java programs or 

20 applications executing on data processing system 250. 

Instructions for the operating system, the object-oriented 
operating system, and applications or programs are located 
on storage devices, such as hard disk drive 276 and may be 
loaded into main memory 254 for execution by processor 252. 

25 Hard disk drives are often absent and memory is constrained 
when data processing system 250 is used as a network client. 
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Those of ordinary skill in the art will appreciate that 
the hardware in Figure 2B may vary depending on the 
implementation. For example, other peripheral devices, such 
as optical disk drives and the like may be used in addition 
5 to or in place of the hardware depicted in Figure 2B. The 
depicted example is not meant to imply architectural 
limitations with respect to the present invention. For 
example, the processes of the present invention may be 
applied to a multiprocessor data processing system. 

10 The present invention operates in a Java runtime 

environment. For example, the present invention may operate 
in conjunction with a Java Virtual Machine (JVM) yet within 
the boundaries of a JVM as defined by Java standard 
specifications. In order to provide a context for the 

15 present invention with regard to an exemplary interpretive 
environment, portions of the operation of a JVM according to 
Java specifications are herein described. 

With reference now to Figure 3, a block diagram 
illustrates the relationship of software components 

20 operating within a computer system that may implement the 
present invention. Java-based system 300 contains platform 
specific operating system 302 that provides hardware and 
system support to software executing on a specific hardware 
platform. JVM 304 is one software application that may 

25 execute in conjunction with the operating system. 

Alternatively, JVM 304 may be imbedded inside a Java 
enabled browser application such as Microsoft Internet 
Explorer™ or Netscape Communicator™. JVM 304 provides a 
Java run-time environment with the ability to execute Java 

30 application or applet 306, which is a program, servlet, or 
software component written in the Java programming language. 
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The computer system in which JVM 304 operates may be similar 
to data processing system 200 or computer 100 described 
above. However, JVM 304 may be implemented in dedicated 
hardware on a so-called Java chip, Java-on-silicon, or Java 
5 processor with an embedded picoJava core. At the center of 
a Java run-time environment is the JVM, which supports all 
aspects of Java's environment, including its architecture, 
security features, mobility across networks, and platform 
independence . 

10 The JVM is a virtual computer, i.e. a computer that is 

specified abstractly. The specification defines certain 
features that every JVM must implement, with some range of 
design choices that may depend upon the platform on which 
the JVM is designed to execute. For example, all JVMs must 

15 execute Java bytecodes and may use a range of techniques to 
execute the instructions represented by the bytecodes. A 
JVM may be implemented completely in software or somewhat in 
hardware. This flexibility allows different JVMs to be 
designed for mainframe computers and PDAs. 

20 The JVM is the name of a virtual computer component 

that actually executes Java programs. Java programs are not 
run directly by the central processor but instead by the 
JVM, which is itself a piece of software running on the 
processor. The JVM allows Java programs to be executed on a 

25 different platform as opposed to only the one platform for 
which the code was compiled. Java programs are compiled for 
the JVM. In this manner, Java is able to support 
applications for many types of data processing systems, 
which may contain a variety of central processing units and 

30 operating systems architectures. To enable a Java 

application to execute on different types of data processing 



13 

Docket No. AUS920010225US1 



systems, a compiler typically generates an 
architecture-neutral file format - the compiled code is 
executable on many processors, given the presence of the 
Java run- time system. 
5 The Java compiler generates bytecode instructions that 

are nonspecific to a particular computer architecture. A 
bytecode is a machine independent code generated by the Java 
compiler and executed by a Java interpreter. A Java 
interpreter is part of the JVM that alternately decodes and 
10 interprets a bytecode or bytecodes. These bytecode 

instructions are designed to be easy to interpret on any 
computer and easily translated on the fly into native 
machine code . 

A JVM must load class files and execute the bytecodes 

15 within them. The JVM contains a class loader, which loads 
class files from an application and the class files from the 
Java application programming interfaces (APIs) which are 
needed by the application. The execution engine that 
executes the bytecodes may vary across platforms and 

20 implementations . 

When an application is executed on a JVM that is 
implemented in software on a platform-specific operating 
system, a Java application may interact with the host 
operating system by invoking native methods. A Java method 

25 is written in the Java language, compiled to bytecodes, and 
stored in class files. A native method is written in some 
other language and compiled to the native machine code of a 
particular processor. Native methods are stored in a 
dynamically linked library whose exact form is platform 

30 specific. 
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As mentioned above, the present invention is directed 
to a mechanism for determine the type of graphical user 
interface (GUI) to be used with a Java property editor to 
edit a Java property. A "property" as the term is used 
5 herein, refers to anything that can be represented by a Java 
class, i.e. a data type. Examples of properties include 
text color, background color, text string, windspeed, 
percentage, computer operating system, and the like. 

Each property has an associated property editor defined 

10 by a programmer using one or more methods for displaying and 
updating property values. These methods may be custom 
methods created by the programmer or may be methods defined 
in the Java PropertyEditor interface. The Java 
Proper tyEdi tor interface defines a plurality of methods that 

15 may be used and combined to generate property editors. A 
table of the methods is provided as Table 1 below. 

A Java PropertyEditorManager further defines a 
plurality of default property editors for various types of 
properties, such as integer, string, and the like. However, 

20 not every property has an associated default property 

editor. Thus, a user may define a custom property editor 
for editing a property using custom methods created by the 
programmer and/or methods provided by the Java 
PropertyEditor interface. The PropertyEditor Interface and 

25 PropertyEditorManager are described in Using Java 1.1 , Third 
Edition, Que Corporation, 1997, pages 824-829, which is 
hereby incorporated by reference. 

With known systems, in order for a user, such as a 
programmer or the like, to edit a property, the user either 

30 designates the property editor that the user wishes to 

invoke or has a PropertyEditorManager determine the default 
property editor to invoke. The PropertyEditorManager 
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identifies property editors for properties by performing a 
string comparison on property editors that are registered 
with the PropertyEditorManager . That is, a property may 
have the name Color. class. The corresponding property 
5 editor would have the name ColorEditor . class . Thus, by 
performing a string comparison on the term "color" the 
correct property editor for the property may be identified. 

The present invention provides a standardized 
graphical user interface (GUI) selection mechanism. The 

10 standardized GUI selection mechanism uses the 

PropertyEditorManager to identify the property editor 
associated with a selected property. Once the property 
editor is identified, the property editor is examined to 
determine which methods in the PropertyEditor Interface are 

15 utilized by the property editor. Based on the 

PropertyEditor Interface methods used by the property 
editor, one of a plurality of predefined standardized GUIs 
is selected that can best be used to provided an interface 
through which the user may edit the property. 



Method 


Description 


Data Type 


AddProper tyChangeListner ( 1 istener ) 


Register a listener for 
the PropertyChange 
event . 


void 


getAsText ( ) 


Gets the property value 
as text . 


string 


getCustomEditor ( ) 


A PropertyEditor may 
choose to make available 
a full customer 
Component that edits its 
property value. 


component 


get JavalnitializationString ( ) 


This method is intended 
for use when generating 
Java code to set the 
value of the property. 


string 
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getTags ( ) 


If the property value 
must be one of a set of 
known tagged values, 
then this method should 
return an array of the 
tags. 


string [ ] 


getValue ( ) 


Gets the property value. 


Object 


isPaintable ( ) 


Determines whether this 
property editor is 
paintable. 


boolean 


pa i ngVa lue ( g f x , box ) 


Paint a representation 
of the value into a 
given area of screen 
real estate. 


void 


ner) 


Remove a listener for 
the Proper tyChange 
event . 


void 


setAsText ( ) 


Set the property value 
by parsing a given 
string. 


void 


setValue (Object value) 


Set (or change) the 
object that is to be 
edited. 


void 


supportsCustomEditor ( ) 


Determines whether this 
property editor supports 
a customer editor. 


boolean 



Table 1 - Java PropertyEditor Interface Methods 

Thus, with the present invention, the same standardized 
5 GUI selection mechanism of the present invention is invoked 
for every property. Thus, the user need not be familiar 
with which property editor or the particular graphical user 
interface for each of the various property editors. In this 
way, a single "editor" is invoked yet a plurality of 
10 different GUIs may be provided. 

With the present invention, when a user selects a 
property that the user wishes to edit, using an interface 
such as a keyboard, computer mouse, or other pointing 
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device, for example, and selects the standardized GUI 
selection mechanism of the present invention either before 
or after selection of the property, the present invention is 
invoked. Upon receiving the selection of the standardized 
5 GUI selection mechanism and the property, the standardized 
GUI selection mechanism invokes the Proper tyEditorManager to 
determine the property editor associated with the selected 
property. Once the property editor is identified using the 
Proper tyEditorManager , the standardized GUI selection 

10 mechanism examines the methods used by the property editor. 
Based on the types of methods used by the property editor, 
one of a plurality of predetermined GUIs is selected for 
presentation to the user. The selected GUI is the output to 
a display device using the fields and values identified by 

15 the property editor. 

Figure 4A is an exemplary diagram of a first GUI 
provided by the present invention for editing a first type 
of property. When the present invention examines the 
methods of the selected property editor, if the standardized 

20 GUI selection mechanism of the present invention determines 
that only the getAsText and setAsText methods of the 
Proper tyEdi tor Interface (see Table 1 above) are implemented 
by the default property editor for the selected property, 
the text field entry GUI 400 is presented to the user. This 

25 is because the property editor of the selected property is 
only able to store and retrieve text values for the 
property. 

The text field entry GUI 400 includes a text field 
entry area 410, a cursor 420, and an entry error indicator 
30 430. The entry error indicator 430 is only visible when 
there is an entry error in the text field entry area 410. 
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Using the text field entry GUI 400, the user may type a text 
string and edit a text string using the cursor 420 in the 
text field entry area 410. 

Entries in the text field entry area 410 are set as the 
5 value of the property using the setAsText method. If during 
entry of the text string an invalid entry is identified, the 
entry error indicator 430 will become visible thereby 
notifying the user of an invalid entry. An invalid entry is 
identified by, for example, the setAsText method of the 
10 property editor throwing an IllegalArgumentException when 
the setAsText method attempts to set the new value as the 
^ value for the property. The present invention receives and 

gp uses this exception as the instigator for displaying the 

Ti entry error indicator 430. 

M 15 Figure 4B illustrates a valid entry in the text field 

entry area 410. The particular example shown in Figure 4B 
is of a property "Process Count" which has a value of 
gfj integer data type. In the example shown, in addition to the 

^ elements 410-430, a property name 440 may also be displayed 

p 20 for informing the user of the property that is being edited. 
r ' Figure 4C illustrates an invalid entry in the text 

field entry area 410 for a particular property. Again the 
property is "Process Count" and has a value of integer data 
type. In the example shown in Figure 4C, a text string 
25 n xxxx" is entered rather than an integer number. Thus, the 
setAsText method of the property editor for the "Process 
Count" property throws an IllegalArgumentException 
indicating that the entry is invalid. As a result, the 
entry error indicator of the present invention is displayed 
30 to thereby inform the user of the invalid entry. 
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If during examination of the methods used by the 
property editor the present invention determines that the 
getTags method of the PropertyEditor Interface is 
implemented, the property editor is determined to provide a 
5 fixed set of values that the property may have. As a 
result, the present invention displays a GUI as shown in 
Figure 5A. 

As shown in Figure 5A, this GUI includes a choice 
selection area popup 510 which is only visible when the 

10 popup virtual button 530 is selected. In addition, the GUI 
includes a current selection region 520 which displays the 
current selection from the choice selection area popup 510. 
It should be noted that this GUI does not include an entry 
error indicator, such as error entry indicator 430, because 

15 there is a predetermined set of possible values for the 
selected property and the user's selection of a value is 
limited to one value from this predetermined set. Thus, all 
possible values must be valid. 

Figure 5B illustrates the GUI of Figure 5A in which an 

20 OS Type is the property and the GUI provides a current 
selection of "WinNT" in the current selection region 520. 
As with the GUI 400, the property name may also be displayed 
in order to inform the user of the property being edited. 

When the user selects the popup button 530, the choice 

25 selection area popup 510 is displayed providing the user 
with other possible values for the selected property. In 
the example shown in Figure 5C, the other possible choices 
for OS Type are AIX, Win98 and Linux. The user may select 
one of these values using a pointing device, one or more 

30 keystrokes, or the like. By selecting a new value using the 
GUI of the present invention, the value for the selected 
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property is reset to the new value using the setAsText 
method of the PropertyEditor Interface. 

If the present invention determines that the property 
editor makes use of the supportsCustomerEditor and 
5 getCustomerEditor methods of the PropertyEditor Interface, 
then the selected property editor must be a custom editor. 
As a result, a different GUI is displayed by the present 
invention, as shown in Figure 6A. 

As shown in Figure 6A, the GUI used for custom editors 

10 includes a text field entry area 610 and an entry error 
indicator 620 similar to those in Figure 4A. In addition, 
the GUI includes a popup custom component area virtual 
button 630. The popup custom component area virtual button 
630, when selected by a user, causes the custom component 

15 popup area 640 to be displayed. The text field entry area 
610 operates in the same manner as that shown in Figure 4A. 
Through the text field entry area 610, a user may input a 
value for the selected property. If the entry in the text 
field entry area 610 is invalid, the entry error indicator 

20 620 will be displayed to inform the user of the invalid 
entry. 

Rather than directly inputting a value for the selected 
property using the text field entry area 610, the user may 
make use of the custom editor generated for the selected 

25 property by selecting the popup custom component area 

virtual button 630. In response to selection of the popup 
custom component area virtual button 630, a custom editor is 
displayed in the custom component area 640. 

Figur 6B illustrates an example custom editor being 

30 displayed in the custom component area 640. In the 

particular example shown, the property being edited is CPU 
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Usage. The user may edit the value for CPU Usage by using 
the custom editor, which in this case is a slider bar, to 
set a new value for the CPU Usage property. The new value 
for CPU Usage is also displayed in the text field entry area 
5 610. The user may operate the custom editor using any 

interface means, such as a pointing device, keyboard, or the 
like. Once the user has selected a new value, the new value 
is set as the value for the property using the setasText 
method or any other "backdoor" method provided by the 

10 programmer of the custom editor. 

Figure 7 is a flowchart outlining an exemplary 
operation of the present invention. As shown in Figure 7, 
the operation starts with receiving a selection of a 
property (step 710) . The Proper tyEditorManager is then 

15 invoked for determining the associated property editor for 
the selected property (step 720) . The property editor is 
then examined to determine the PropertyEditor Interface 
methods utilized by the property editor (step 730) . Based 
on the identified methods of the PropertyEditor Interface, a 

20 suitable graphical user interface for property editor is 
selected (step 740) . The selected graphical user interface 
is then output to the user (step 750) who may use the 
interface to change the value of the selected property in 
the manner described above. 

25 The following is a listing of pseudo-code for 

performing the functions of the present invention. While 
the preferred embodiment makes use of computer implemented 
instructions for performing the functions of the present 
invention, one of ordinary skill in the art will appreciate 

30 that the functions of the present invention may also be hard 
coded into hardware that may be used to implement the 
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present invention. Also, a combination of a hardware and 
software approach may be utilized without departing from the 
spirit and scope of the present invention. 

##################################################################### 
Pseudo-code data flow {Procedures are flagged in italics.) 

##################################################################### 
// 

// Check if PropertyEditor provides a list of valid value choices. 
// 

If ( UseSelectListGUI?) 
{ 

// 

// Create editor GUI shown in Figure 5A. 

// 

Do CreateSelectListGUI 

// 

//As end-user interacts with editor GUI, update 
// PropertyEditor value. 

// 

While ( UserEventToSelectListGUI?) 
{ 

Do Upda t eFromSel ec tLi s tGUI 

} 

} 

// 

// Else check if PropertyEditor supports textual editing AND provides 
// a custom GUI component. 

// 



23 

Docket No. AUS920010225US1 

Else if ( UseTextField&CustomComponentGUI?) 
{ 

// 

// Create editor GUI shown in Figure 6A. 

// 

Do Crea teTextFi eld&CustomComponen tGUI 

/ / 

// As end-user interacts with editor GUI, update 
// PropertyEditor value. 

// 

Whi le ( UserEventToTextFi eld&CustomComponen tGUI ? ) 
{ 

Do UpdateFromTextFi el d&CustomComponen tGUI 

} 

} 

// 

// Else check if PropertyEditor supports textual editing ONLY . 
// 

Else if (UseTextFieldOnlyGUI?) 
{ 

// 

// Create editor GUI shown in Figure 4A. 

// 

Do CreateTextFieldOnlyGUI 

/ / 

//As end-user interacts with editor GUI, update 
// PropertyEditor value. 

// 

While ( UserEventToTextFieldOnlyGUI?) 
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Do UpdateFromTextFieldOnlyGUI 

} 

} 

5 /7 

// Else check if Proper tyEdi tor provides a custom GUI component ONLY. 
// 

Else if (UseCustomComponentOnlyGUI?) 
{ 

10 // 

// Create editor GUI by using custom component. 

// 

Do CreateCustomComponentOnlyGUI 

} 

15 // 

// Else PropertyEditor does NOT support value editing. 

// 

Else 
{ 

20 // 

// Create read-only display GUI shown. 

// 

Do CreateDisplayOnlyGUI 

} 

25 

################################################################### 

Procedures (Methods from Proper tyEdi tor interface are flagged in 
italics. Data types returned from methods are flagged in bold.) 

################################################################### 
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Procedure UseTextFieldOnlyGUI 
{ 

If method getAsText returns non-null and method getTags returns 
null and method supportsCustomEditor returns false then use editor 
5 GUI shown in Figure 4A. 

} 



Procedure CreateTextFieldOnlyGUI 
{ 

10 Create error display indicator (430) and text field entry area 

(410). Populate text field entry area (410) with String returned 
from method getAsText. 

} 



15 Procedure UserEventToTextFieldOnlyGUI? 
{ 

When character is typed into text field entry area (410), a user 
event is detected. 

} 

20 

Procedure UpdateFromTextFieldOnlyGUI 

{ 

Get the current display value String from the text field entry 
area (410) and pass it to method setAsText. If the method throws 
25 an II legal Argument Except ion an invalid entry is detected, tell the 

error display indicator (430) to indicate an error condition. 

} 



30 Procedure UseSelectListGUI? 
{ 

If method getAsText returns non-null and method getTags returns 
non-null then use editor GUI shown in Figure 5A. 

} 
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Procedure CreateSelectListGUI 
{ 

Create choice selections. Populate choice list with String array 
5 returned from method getTags. 

} 



Procedure UserEventToSelectListGUI? 
{ 

10 When a selection is made from the choice selection popup (510), a 

user event is detected. 

} 



Procedure UpdateFromSelectListGUI 

15 { 

Get the current selected display value String from the current 
selection region (520) and pass it to method setAsText . The method 
should never throw an IllegalArgumentException because the choice 
is limited only to allowed values. 



t 20 } 



Procedure UseText Field&Cus tomComponentGUI ? 
{ 

If method getAsText returns non-null and method getTags returns 
25 null and method support sCustomEdi tor returns true then use editor 

GUI shown in Figure 6A. 



Procedure CreateTextField&Cus tomComponentGUI 
30 { 

Create error display indicator (620) and text field entry area 
(610). Populate text entry field widget with String returned from 
method getAsText. Create custom component popup virtual button 
(630) and populate custom component popup area (640) with GUI 
35 Component returned from method getCustomEditor . Use method 
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addPropertyChangeListener to register a listener that is notified 
when the custom component's display value changes (as it will when 
the end-user interacts with it.) This listener's responsibility is 
to update the display value of the text field entry area (610), 
5 keeping it in sync with the custom component's display value. 

} 



Procedure UserEventToTextField&CustomComponentGUI ? 
{ 

10 When character is typed into text field entry area (610), a user 

event is detected. 

} 



M Procedure UpdateFromTextField&CustomComponentGUI 

| 15 { 

Z7= Get the current display value String from text field entry area 

(610) and pass it to method setAsText. If the method throws an 
IllegalArgumentException an invalid entry is detected, tell the 

%J error display indicator (620) to indicate an error condition. 

fy 20 Since the custom component is created by the property editor 

interface, it's property value update mechanism is a detail of the 

^ property editor implementers and is of no concern to this 

J jf invention. 

4 > 

£ 25 

W 

Procedure UseCustomComponentOnlyGUI? 
{ 

If method gret^sText returns null and method getTags returns null 
and method supportsCustomEditor returns true then use editor GUI 
30 shown in Figure 6A. 

} 



Procedure CreateCustomComponentOnlyGUI 
{ 

35 Get the GUI Component returned from method getCustomEditor and use 

it as the editor GUI. Since the custom component is created by the 
property editor interface, it's property value update mechanism is 
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a detail of the property editor implementers . 

} 



Procedure CreateDisplayOnlyGUI 
5 { 

If method getAsText returns non-null then use returned String to 
populate a read-only text display area. Otherwise, if method 
isPaintable returns true then use method paintValue to paint an 
image on an image display area. 

10 } 

Thus, the present invention provides a mechanism by 
which a single standardized GUI selection mechanism may be 
invoked for editing all types of properties. The 

15 standardized GUI selection mechanism of the present 

invention examines the methods used by a property editor of 
a selected property. Based on the types of methods invoked, 
the present invention provides one of a number of 
predetermined graphical user interfaces suited for editing 

20 of that type of property. Thus, the user need not have an a 
priori knowledge of each property's editor in order to edit 
the property. 

While the above examples of the preferred embodiments 
of the present invention illustrate specific examples of 

25 graphical user interfaces that are displayed based on 

information obtained from metadata of selected properties, 
the present invention is not limited to the particular 
graphical user interfaces described above. Rather, the 
present invention is applicable to provide any type of 

30 graphical user interface suitable for editing a selected 
property based on an analysis of metadata for the selected 
property. Modifications to the graphical user interfaces 
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described above are intended to be within the spirit and 
scope of the present invention. 

It is important to note that while the present 
invention has been described in the context of a fully 
5 functioning data processing system, those of ordinary skill 
in the art will appreciate that the processes of the present 
invention are capable of being distributed in the form of a 
computer readable medium of instructions and a variety of 
forms and that the present invention applies equally 

10 regardless of the particular type of signal bearing media 
actually used to carry out the distribution. Examples of 
computer readable media include recordable- type media such a 
floppy disc, a hard disk drive, a RAM, and CD-ROMs and 
transmission-type media such as digital and analog 

15 communications links. 

The description of the present invention has been 
presented for purposes of illustration and description, but 
is not intended to be exhaustive or limited to the invention 
in the form disclosed. Many modifications and variations 

20 will be apparent to those of ordinary skill in the art. The 
embodiment was chosen and described in order to best explain 
the principles of the invention, the practical application, 
and to enable others of ordinary skill in the art to 
understand the invention for various embodiments with 

25 various modifications as are suited to the particular use 
contemplated. 



